Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add foreach processor documentation #5981

Merged
merged 12 commits into from
May 28, 2024
Merged

Add foreach processor documentation #5981

merged 12 commits into from
May 28, 2024

Conversation

vagimeli
Copy link
Contributor

Description

Closes content gap

Issues Resolved

#4647

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

@vagimeli vagimeli added Needs SME Waiting on input from subject matter expert Content gap labels Dec 22, 2023
@vagimeli vagimeli self-assigned this Dec 22, 2023
@vagimeli
Copy link
Contributor Author

@hdhalter We need a dev to take the first pass at drafting this content. I can support them in refining the content and getting it through the documentation process. The ingest processor template is provided with this PR, so it should help the dev get started. Thanks!

@vagimeli vagimeli marked this pull request as draft February 15, 2024 21:14
@vagimeli vagimeli marked this pull request as ready for review May 22, 2024 15:55
@vagimeli vagimeli changed the title [DOC] Add foreach processor documentation Add foreach processor documentation May 22, 2024
@vagimeli vagimeli added the backport 2.14 PR: Backport label for 2.14 label May 22, 2024
_ingest-pipelines/processors/foreach.md Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
Signed-off-by: Melissa Vagi <[email protected]>
@vagimeli vagimeli added the 5 - Editorial review PR: Editorial review in progress label May 24, 2024
Copy link
Collaborator

@natebower natebower left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vagimeli LGTM with the noted comments and changes. Thanks!

_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved
|-----------|-----------|-----------|
`field` | Required | The array field to iterate over.
`processor` | Required | The processor to execute against each field.
`ignore_missing` | Optional | If `true` and the specified field does not exist or is null, the processor will quietly exit without modifying the document.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is "quietly" necessary here? If it's a technical term and adds context, then fine as is.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's a technical expression that means hat the processor will terminate or exit its execution without performing any further actions or modifications to the document and without producing any errors or notifications.

_ingest-pipelines/processors/foreach.md Outdated Show resolved Hide resolved

#### Response

The following example response confirms that the pipeline is working as expected, showing the four elements have been lowercased:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"that" should precede either "the four" or "have been", depending on the meaning.

]
}
}
gaobinlong1 day ago
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove?

@vagimeli vagimeli merged commit fe979d5 into main May 28, 2024
6 checks passed
@github-actions github-actions bot deleted the foreach-processor branch May 28, 2024 18:51
opensearch-trigger-bot bot pushed a commit that referenced this pull request May 28, 2024
* Add foreach processor documentation

Signed-off-by: Melissa Vagi <[email protected]>

* Add pipeline example requests and responses

Signed-off-by: Melissa Vagi <[email protected]>

* Add pipeline examples

Signed-off-by: Melissa Vagi <[email protected]>

* Address tech review comments

Signed-off-by: Melissa Vagi <[email protected]>

* Update _ingest-pipelines/processors/foreach.md

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Melissa Vagi <[email protected]>

* Update _ingest-pipelines/processors/foreach.md

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Melissa Vagi <[email protected]>

* Address editorial review comments

Signed-off-by: Melissa Vagi <[email protected]>

---------

Signed-off-by: Melissa Vagi <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
(cherry picked from commit fe979d5)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
@vagimeli vagimeli removed the 5 - Editorial review PR: Editorial review in progress label Jun 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport 2.14 PR: Backport label for 2.14 Content gap Needs SME Waiting on input from subject matter expert
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants